home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / vms122.zip / VMAIL.DOC < prev    next >
Text File  |  1992-05-13  |  41KB  |  1,797 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                      V-MailServer
  14.                                      User Manual
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                                                Release 1.22
  25.  
  26.  
  27.  
  28.                                                                May 13, 1992
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                                                   Vandenberg
  40.                                                   Systems
  41.                                                   Research
  42.  
  43.  
  44.  
  45.  
  46.           V-MailServer User Manual
  47.            
  48.           
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.           Copyright (c) 1991 Richard Vandenberg and
  106.           Vandenberg Systems Research                                    ii
  107.  
  108.  
  109.  
  110.           
  111.                                               
  112.           
  113.           
  114.                                                         Licensing Agreement
  115.           
  116.           
  117.                                               
  118.           
  119.           
  120.  
  121.  
  122.           V-MailServer is Copyright (c) 1992 Vandenberg Systems Research and
  123.           Richard Vandenberg.
  124.  
  125.  
  126.           Mailing address:
  127.  
  128.           Richard Vandenberg
  129.           Vandenberg Systems Research
  130.           1016 West 12th Avenue #103
  131.           Vancouver, BC Canada
  132.           V6H 1L3
  133.  
  134.           Telephone: (604) 737-2532
  135.  
  136.           Email: rick@vsystem.wimsey.bc.ca
  137.  
  138.           V-MailServer was developed by Richard Vandenberg and Vandenberg
  139.           Systems Research.
  140.  
  141.           V-MailServer is the sole property of Richard Vandenberg.
  142.  
  143.           The V-MailServer files are packaged together as a single unit in
  144.           a PKZIP (tm) generated archive file.
  145.  
  146.           UNDER NO CIRCUMSTANCES MAY ANYONE MODIFY THE VSYSTEM UTILITIES
  147.           FILES, OR MODIFY THE ARCHIVE IN ANY FASHION, OR DISTRIBUTE
  148.           V-MAILSERVER IN ANY OTHER FORM THAN THE PKZIP(tm) FORMAT ARCHIVE
  149.           IT WAS ORIGINALLY ISSUED.
  150.  
  151.  
  152.           The V-MailServer programs are "shareware programs" and are
  153.           provided at no charge to the user for evaluation.  Feel free to
  154.           share them with your friends, but please do not give it away
  155.           altered or as part of another system.  
  156.  
  157.           The essence of "user-supported" software is to provide personal
  158.           computer users with quality software without high prices, and yet
  159.           to provide incentive for programmers to continue to develop new
  160.           products.  
  161.  
  162.           If you find these programs useful and find that you are using
  163.           V-MailServer and continue to use V-MailServer after a 60 day
  164.           trial period, you must make a registration payment of $35 Can
  165.           ($30 US) to Rick Vandenberg.  This registration fee will license
  166.           one copy of V-MailServer for use on any one computer at any one
  167.  
  168.  
  169.  
  170.           Copyright (c) 1991 Richard Vandenberg and
  171.           Vandenberg Systems Research                                   iii
  172.  
  173.  
  174.  
  175.  
  176.           V-MailServer User Manual
  177.            
  178.           
  179.  
  180.           time.  You must treat this software just like a book.  ie. - Only
  181.           one person may use it at a time.  
  182.  
  183.           Commercial users of V-MailServer must register and pay for their
  184.           copies of V-MailServer within 30 days of first use or their
  185.           license is withdrawn.  Other licensing arrangements may be made
  186.           by contacting Rick Vandenberg.
  187.  
  188.           Anyone distributing V-MailServer for any kind of remuneration
  189.           must first contact Rick Vandenberg at the address below for
  190.           authorization.
  191.  
  192.           Commercial Information Services may distribute V-MailServer if
  193.           there are no charges for obtaining this software, other than
  194.           regular charges for on-line time.
  195.  
  196.  
  197.           You are encouraged to pass a copy of V-MailServer along to your
  198.           friends for evaluation.  Please encourage them to register their
  199.           copy if they find that they can use it.
  200.  
  201.  
  202.           The registration form is included in the file REGISTER.DOC.
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.           Copyright (c) 1991 Richard Vandenberg and
  236.           Vandenberg Systems Research                                    iv
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.                                                            Limited Warranty
  245.  
  246.  
  247.  
  248.  
  249.           V-MAILSERVER IS SUPPLIED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  250.           EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
  251.           IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  252.           PARTICULAR PURPOSE. THE ENTIRE RISK RELATING TO THE QUALITY AND
  253.           PERFORMANCE OF THE PROGRAMS IS ON YOU. IN THE EVENT THERE IS ANY
  254.           DEFECT, YOU ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING,
  255.           REPAIR, OR CORRECTION. SOME PROVINCES OR STATES DO NOT ALLOW THE
  256.           EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT
  257.           APPLY TO YOU.  THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND
  258.           YOU MAY HAVE OTHER RIGHTS WHICH VARY FROM PROVINCE TO PROVINCE
  259.           AND STATE TO STATE.
  260.  
  261.  
  262.           Richard Vandenberg and Vandenberg Systems Research do not warrant
  263.           that the functions contained in the programs will meet your
  264.           requirements or that the programs will be interrupted or error-
  265.           free.
  266.  
  267.           IN NO EVENT WILL RICHARD VANDENBERG OR VANDENBERG SYSTEMS
  268.           RESEARCH BE LIABLE TO YOU FOR ANY DAMAGES (INCLUDING ANY LOST
  269.           PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL
  270.           DAMAGES ARISING OUT OF THE USE OF OR INABILITY TO USE SUCH
  271.           PROGRAMS EVEN IF RICHARD VANDENBERG OR VANDENBERG SYSTEMS
  272.           RESEARCH HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES) OR
  273.           FOR ANY CLAIM BY ANY OTHER PARTY. SOME PROVINCES AND STATES DO
  274.           NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL
  275.           OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR EXCLUSION MAY
  276.           NOT APPLY TO YOU.
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.           Copyright (c) 1991 Richard Vandenberg and
  301.           Vandenberg Systems Research                                     v
  302.  
  303.  
  304.  
  305.  
  306.           V-MailServer User Manual
  307.            
  308.           
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.           Copyright (c) 1991 Richard Vandenberg and
  366.           Vandenberg Systems Research                                    vi
  367.  
  368.  
  369.  
  370.           
  371.                                               
  372.           
  373.           
  374.                                                           Table of Contents
  375.           
  376.           
  377.                                               
  378.           
  379.           
  380.  
  381.  
  382.           Limited Warranty  . . . . . . . . . . . . . . . . . . . . . .   v
  383.  
  384.           Installation  . . . . . . . . . . . . . . . . . . . . . . . .   3
  385.                Planning the configuration . . . . . . . . . . . . . . .   3
  386.                Basic Configuration  . . . . . . . . . . . . . . . . . .   3
  387.  
  388.           File Server Services  . . . . . . . . . . . . . . . . . . . .   4
  389.                Processing the Queued requests . . . . . . . . . . . . .   4
  390.                Setting up the SearchTree and ValidPaths files . . . . .   4
  391.  
  392.           Mailing lists . . . . . . . . . . . . . . . . . . . . . . . .   7
  393.                Setting up a public mailing list . . . . . . . . . . . .   7
  394.  
  395.           Automatic file sending services . . . . . . . . . . . . . . .   8
  396.  
  397.           Configuration . . . . . . . . . . . . . . . . . . . . . . . .   9
  398.                Configuration File . . . . . . . . . . . . . . . . . . .   9
  399.  
  400.           Command Line Options  . . . . . . . . . . . . . . . . . . .    15
  401.                VMAIL Options  . . . . . . . . . . . . . . . . . . . .    15
  402.                VMAILX Options . . . . . . . . . . . . . . . . . . . .    16
  403.  
  404.           Other Files . . . . . . . . . . . . . . . . . . . . . . . .    18
  405.                UserDir File and UserSecurity File . . . . . . . . . .    18
  406.                Request Processing . . . . . . . . . . . . . . . . . .    18
  407.  
  408.           List server functions . . . . . . . . . . . . . . . . . . .    19
  409.                Public Mailing List Files  . . . . . . . . . . . . . .    20
  410.                Private Mailing List Files . . . . . . . . . . . . . .    21
  411.                Request Logging  . . . . . . . . . . . . . . . . . . .    21
  412.                Traffic Control File . . . . . . . . . . . . . . . . .    21
  413.  
  414.           Additional Programs . . . . . . . . . . . . . . . . . . . .    22
  415.                KILLTRAF . . . . . . . . . . . . . . . . . . . . . . .    22
  416.                TRAF2CDF . . . . . . . . . . . . . . . . . . . . . . .    22
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.           Copyright (c) 1991 Richard Vandenberg and
  431.           Vandenberg Systems Research                                     1
  432.  
  433.  
  434.  
  435.  
  436.           V-MailServer User Manual
  437.            
  438.           
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.           Copyright (c) 1991 Richard Vandenberg and
  496.           Vandenberg Systems Research                                     2
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                                                                Installation
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.           Before installing V-MailServer, you should plan your
  512.           configuration.  V-MailServer has many features and you may or may
  513.           not need them all.  Descriptions of all the configuration file
  514.           options starts on page 9.
  515.  
  516.  
  517.  
  518.           Planning the configuration
  519.  
  520.           V-MailServer can provide mail server, mailing list, and automatic
  521.           file server capabilities. You must perform the basic
  522.           configuration described below.  After that you can set up and
  523.           options you need.
  524.  
  525.  
  526.  
  527.           Basic Configuration
  528.  
  529.           The VINSTALL program can completely install V-MailServer, and
  530.           setup example mail list and automatic file server features. See
  531.           the file README for a very brief description of how to run
  532.           VINSTALL.
  533.  
  534.           You should create an environment variable 'VMS', which points to
  535.           the configuration file.  For example:
  536.  
  537.           SET VMS=C:\WAFFLE\VMS\VMS.CFG
  538.  
  539.           It's a good idea to add this line to your AUTOEXEC.BAT file, or
  540.           to the batch file that starts up you mail system. VINSTALL will
  541.           create a small batch file, VSET.BAT that contains the correct SET
  542.           command for this.
  543.  
  544.           You will now need to add a few lines to your 'aliases' file.
  545.           Assuming you want to use the name 'mail-server' for access to
  546.           V-MailServer, add this line to your 'aliases' file:
  547.  
  548.           mail-server    | c:\waffle\vms\vmail.exe
  549.  
  550.           Again, after running VINSTALL, the file ALIASES.ADD contains the
  551.           alias entries that are needed.
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.           Copyright (c) 1991 Richard Vandenberg and
  561.           Vandenberg Systems Research                                     3
  562.  
  563.  
  564.  
  565.  
  566.           V-MailServer User Manual
  567.            
  568.           
  569.  
  570.           File Server Services
  571.  
  572.  
  573.           In order to use V-MailServer as a mail based file server, you
  574.           will need to tell V-MailServer where to look for the files, and
  575.           which directories are valid.
  576.  
  577.           V-MailServer can be set up to access any drive or directory
  578.           available.  Two files are needed to use the File Server features. 
  579.           One is called the SEARCHTREE file.  It's a list of directories to
  580.           search for files.  The other is the VALIDPATHS file.  This file
  581.           must list the full subdirectory name for each subdirectory that
  582.           can be accessed.
  583.  
  584.           You will also need to provide a UUencoder program.  UUEncode by
  585.           Richard Marks is recommended, but you may use any UUencode
  586.           program you wish.  We chose Richard Marks' program because it
  587.           will create multi-part uuencoded files, which V-MailServer needs
  588.           to send large files.
  589.  
  590.  
  591.           Processing the Queued requests
  592.  
  593.           As a default, VMAIL will queue the requests in the QUEUE
  594.           subdirectory. To actually pass these requests to the mailer to be
  595.           sent off, you must the VMAILX program.
  596.  
  597.           VMAILX takes each queued entry, and passes it to RMAIL. The
  598.           default is to process all of the requests that are queued.
  599.  
  600.           To fine tune the processing function, VMAILX has a number of
  601.           command line options available.  They're described in detail on
  602.           page 16.  In a nutshell, the options allow you to process the
  603.           requests based on file specification and to limit the number of
  604.           bytes processed in a given session.
  605.  
  606.  
  607.  
  608.           Setting up the SearchTree and ValidPaths files
  609.  
  610.           These two files control access to all files that may be retrieved
  611.           using the GET (or equivalent) command. 
  612.  
  613.           In order for V-MailServer to find a file, it must know where to
  614.           look.  It does this by using the Searchtree file.  Here is a
  615.           sample Searchtree file:
  616.  
  617.           c:\public
  618.           d:\extra
  619.           d:\misc
  620.  
  621.           If a GET command is processed - eg. 'GET xyz.zip' - V-MailServer
  622.           will search for that file in each directory listed in the
  623.  
  624.  
  625.           Copyright (c) 1991 Richard Vandenberg and
  626.           Vandenberg Systems Research                                     4
  627.  
  628.  
  629.  
  630.  
  631.                                                                Installation
  632.                                               
  633.           
  634.  
  635.           Searchtree file.  It does this search by taking one of the
  636.           directories listed, and appending the requested filename to it to
  637.           create a full path to the file.
  638.  
  639.           The Validpaths files contains a list of all legal directories
  640.           that may be accessed.  Taking the above example, if the three
  641.           directories were the only ones you wanted to have available you
  642.           would simply put the following in the Validpaths file:
  643.  
  644.           c:\public
  645.           d:\extra
  646.           d:\misc
  647.  
  648.  
  649.           By default, VINSTALL sets up the ValidPaths file to give access
  650.           to the entire subdirectory structure under the named public files
  651.           directories.  Simply delete any lines that you wish to disable
  652.           access to.
  653.  
  654.           For a more complex example, assume that you have the following
  655.           directory structures. On drive 'c:' we want the 'pc' and 'misc'
  656.           subdirectories to be available.  The '\other\private\share'
  657.           subdirectory on drive 'd:' should not be accessible, but those
  658.           below it should be.  Let's also say that we want users to request
  659.           files using the convention 'dir1/dir2/name' - ie. pc/asm/filename
  660.           or misc/xyz.
  661.  
  662.           c:\public
  663.           └───ftp
  664.               ├───pc
  665.               │   ├───asm
  666.               │   └───c
  667.               └───misc
  668.  
  669.           d:\other
  670.           └───private
  671.               └───share
  672.                   └───pc
  673.                       └───asm
  674.  
  675.  
  676.           The first step is to have V-MailServer start off with the correct
  677.           directories when searching.  In the Searchtree file, put these
  678.           lines:
  679.  
  680.           c:\public\ftp
  681.           d:\other\private\share
  682.  
  683.  
  684.           In the Validpaths file, you must name all of the valid paths:
  685.  
  686.           c:\public\ftp\pc
  687.           c:\public\ftp\pc\asm
  688.  
  689.  
  690.           Copyright (c) 1991 Richard Vandenberg and
  691.           Vandenberg Systems Research                                     5
  692.  
  693.  
  694.  
  695.  
  696.           V-MailServer User Manual
  697.            
  698.           
  699.  
  700.           c:\public\ftp\pc\c
  701.           c:\public\ftp\misc
  702.           d:\other\private\share\pc
  703.           d:\other\private\share\pc\asm
  704.  
  705.  
  706.           If a request has just the filename, V-MailServer will first try
  707.           'c:\public\ftp\filename', which will fail because this path is
  708.           not listed in the Validpaths file.  Then it will try
  709.           'd:\other\private\share\filename', which will fail for the same
  710.           reason.
  711.  
  712.           If a request uses 'pc/asm/filename' for example, V-MailServer
  713.           first tries c:\public\ftp\pc\asm\filename. It is a legal path, so
  714.           it will attempt to find the file. If it doesn't exist, the next
  715.           attempt uses 'd:\other\private\share\pc\asm\filename'.
  716.  
  717.           V-MailServer will accept any legal MSDOS file specification. 
  718.           These include
  719.  
  720.           filename
  721.           \filename
  722.           c:filename
  723.           c:\filename
  724.           ..\filename
  725.           .\filename
  726.           c:..\dir11\dir2\dir3\..\dir4\filename
  727.  
  728.           and others.
  729.  
  730.           Each file specification is converted to a fully-qualified path
  731.           name, which is then compared to the paths listed in the
  732.           Validpaths file.
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.           Copyright (c) 1991 Richard Vandenberg and
  756.           Vandenberg Systems Research                                     6
  757.  
  758.  
  759.  
  760.  
  761.                                                                Installation
  762.                                               
  763.           
  764.  
  765.           Mailing lists
  766.  
  767.  
  768.           V-MailServer provides two type of mailing list services - public
  769.           and private.
  770.  
  771.           Public mailing lists provide a mechanism to make group
  772.           communication easier.  People with a common interest can join a
  773.           mailing list dedicated to specific topics.  Members can subscribe
  774.           and unsubscribe to the list at their option.  Any message sent to
  775.           the mailing list address is automatically forwarded to all
  776.           members on the list.
  777.  
  778.           Public mailing lists each have a membership file that contains
  779.           the mail addresses of all subscribers.  There is one master
  780.           mailing list file that contains the name of each mailing list and
  781.           the full pathname of the file that contains the membership
  782.           information.
  783.  
  784.           Private mailing lists are similar in some ways to public mailing
  785.           lists.  A private mailing list is kept in a user directory, which
  786.           is created by the system administrator for a specific user.  The
  787.           user may send a file to his user directory using the PUT command. 
  788.           The CREATELIST command is used to save a mailing list file in the
  789.           user directory as well.  The command which provides the actual
  790.           mailing list features is the RESEND command.  Using this command,
  791.           the user may send a file to all members of a user-created mailing
  792.           list. 
  793.  
  794.  
  795.           Setting up a public mailing list
  796.  
  797.           To set up a public mailing list you must first create a
  798.           MAILLINGLISTS file.  This file is a master list of all mailing
  799.           lists residing on your machine. Beside the name of each mailing
  800.           list is the name of the file that contains the membership
  801.           information. There is a sample file called 'maillist' this is
  802.           supplied with V-MailServer.  You should modify this file to suit
  803.           your needs.  The format of each line is:
  804.  
  805.           mailing-list-name FullPathNameOfMembershipFile
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.           Copyright (c) 1991 Richard Vandenberg and
  821.           Vandenberg Systems Research                                     7
  822.  
  823.  
  824.  
  825.  
  826.           V-MailServer User Manual
  827.            
  828.           
  829.  
  830.           Automatic file sending services
  831.  
  832.  
  833.           For some purposes, it is desirable to create a address that
  834.           automatically sends files in response to a message sent to it. 
  835.           For example, sending a message to
  836.           vmail-info-request@vsystem.wimsey.bc.ca will automatically
  837.           retrieve a file containing a short blurb on V-MailServer.
  838.  
  839.           AFS is implemented using a file that contains on each line an
  840.           address followed by the file to send.  Each time a message is
  841.           processed through V-MailServer, the AFSFILE is checked to see if
  842.           the To: address is one listed.  If so, the file is queued and the
  843.           request is completed.
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.           Copyright (c) 1991 Richard Vandenberg and
  886.           Vandenberg Systems Research                                     8
  887.  
  888.  
  889.  
  890.  
  891.                                                                Installation
  892.                                               
  893.           
  894.  
  895.  
  896.  
  897.  
  898.  
  899.                                                               Configuration
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.           Configuration File
  907.  
  908.  
  909.           The following variables are used in the configuration file:
  910.  
  911.  
  912.           MAILPROGRAM
  913.  
  914.                The mail delivery program of you choice.
  915.                Generally, it is RMAIL. You should specify the
  916.                full path to it.
  917.  
  918.  
  919.           UUEPROG
  920.  
  921.                The UUencoding program. It should be able to place
  922.                it's output into one or more files.
  923.  
  924.  
  925.           UUENCODEOPTIONS
  926.  
  927.                The option string to pass to the UUencode program
  928.                specified above.  These options are always passed,
  929.                no matter which encoding method is chosen.
  930.  
  931.  
  932.           UUENCODE_SWITCH and XXENCODE_SWITCH
  933.  
  934.                The UUENCODE program's command line switches to
  935.                enable UUencoding or XXencoding.  The appropriate
  936.                option is passed based on which encoding option
  937.                the request specifies.  UUEncoding is the default.
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.           Copyright (c) 1991 Richard Vandenberg and
  951.           Vandenberg Systems Research                           9
  952.  
  953.  
  954.  
  955.  
  956.           V-MailServer User Manual
  957.            
  958.           
  959.  
  960.           UUETEMP
  961.  
  962.                The name of the output file for the UUencoder. 
  963.                Most UUDecoders will create multipart files, based
  964.                on a prefix that you supply. If, for example, with
  965.                Richard Marks' UUEncode program you supply the
  966.                name C:\TEMP\VSRUX, the output files will be named
  967.                in the following fashion: C:\TEMP\VSRUX1.UUE,
  968.                C:\TEMP\VSRUX2.UUE, C:\TEMP\VSRUX3.UUE, and so on.
  969.  
  970.           UUEOUTPUTSPEC
  971.  
  972.                Used for multi-part UUencoded requests. Most
  973.                UUencoders will create multiple files for multi-
  974.                part UUencodes. They should have simple format
  975.                that they use to name the multiple files.  Richard
  976.                Mark's Uuencode will number the files
  977.                sequentially, for example. Eg. VSRUUE1.UUE,
  978.                VSRUUE2.UUE and so on.  In this case, using
  979.                VSRUUE*.UUE will find all the UUEncoded sections. 
  980.                After the file has been UUEncoded, V-MailServer
  981.                will use the UUEOUTPUTSPEC as a search pattern to
  982.                find the file(s) to send.
  983.  
  984.  
  985.           SERVERNAME
  986.  
  987.                The name of the server, for use in the 'From:'
  988.                field in the header.
  989.  
  990.  
  991.           SENDERNAME
  992.  
  993.                The name used in the header fields 'Sender:', and 
  994.                on the UUCP 'From ' path line.  The SENDERNAME
  995.                should be different from the SERVERNAME, so that
  996.                bounce mails and the like aren't sent back to the
  997.                mail server address.
  998.  
  999.  
  1000.           TEMPMAILFILE
  1001.  
  1002.                The temporary file used when creating any mail. 
  1003.                You can choose any name that suits you.  If you
  1004.                have a RAM disk or other directory that is used
  1005.                for temporary files you should use that. Eg. -
  1006.                E:\VMTEMP or C:\TEMP\TEMPMAIL.
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.           Copyright (c) 1991 Richard Vandenberg and
  1016.           Vandenberg Systems Research                          10
  1017.  
  1018.  
  1019.  
  1020.  
  1021.                                                               Configuration
  1022.                                               
  1023.           
  1024.  
  1025.           HELPFILE
  1026.  
  1027.                The fully qualified name of the file to send in
  1028.                response to the 'HELP' command.
  1029.  
  1030.  
  1031.           INDEXFILE
  1032.  
  1033.                The fully qualified name of the file to send in
  1034.                response to the 'INDEX' command.
  1035.  
  1036.  
  1037.           VALIDPATHS
  1038.  
  1039.                Contains the directory names of all the valid
  1040.                directories that may be accessed via V-MailServer
  1041.                requests.  It is used for security.  More
  1042.                information about the VALIDPATHS file is in the
  1043.                section 'Other Files'.
  1044.  
  1045.  
  1046.           SEARCHTREE
  1047.  
  1048.                Contains the names of all the directories to
  1049.                search when requesting a file.  When a file is
  1050.                requested, each of the paths listed in the
  1051.                SEARCHTREE file is used to form the full path
  1052.                specification of the file to be retrieved.  More
  1053.                information about the SEARCHTREE file is in the
  1054.                section 'Other Files'.
  1055.  
  1056.  
  1057.           LOGFILE
  1058.  
  1059.                The name of the V-MailServer request log.  Each
  1060.                request is logged in this file, along with the
  1061.                date, time, requester.
  1062.  
  1063.  
  1064.           STATUSWORKFILE
  1065.  
  1066.                A temporary file for holding the 'status' message
  1067.                while it is being created during the execution of
  1068.                the request.
  1069.  
  1070.  
  1071.           REJECTFILE
  1072.  
  1073.                Contains the addresses of any users or domains to
  1074.                disallow V-MailServer access for.  Specifying a
  1075.                partial domain will disallow access to ALL users
  1076.                in that domain.
  1077.  
  1078.  
  1079.  
  1080.           Copyright (c) 1991 Richard Vandenberg and
  1081.           Vandenberg Systems Research                          11
  1082.  
  1083.  
  1084.  
  1085.  
  1086.           V-MailServer User Manual
  1087.            
  1088.           
  1089.  
  1090.           INFOPATH
  1091.  
  1092.                The path to look in for file used by the INFO
  1093.                command. The subject of the INFO command may be up
  1094.                to 11 characters long.  The INFO command simply
  1095.                retrieves the file with the same name as the
  1096.                subject of the INFO command.
  1097.  
  1098.  
  1099.           TRAFFICCONTROL
  1100.  
  1101.                The file used to monitor traffic.
  1102.  
  1103.  
  1104.           USERDIRFILE
  1105.  
  1106.                Contains the address and the user directory for
  1107.                any people who you have set up a user directory
  1108.                for.
  1109.  
  1110.  
  1111.           USERSECURITYFILE
  1112.  
  1113.                Contains the legal user directories a user may
  1114.                access.
  1115.  
  1116.  
  1117.           DAILYLIMIT
  1118.  
  1119.                Allows you to limit the volume of requests from a
  1120.                user on a daily basis.  Any requests which would
  1121.                create more traffic than this will be rejected.
  1122.  
  1123.  
  1124.           MESSAGELIMIT
  1125.  
  1126.                Allows you to limit the volume of requests from a
  1127.                user on a message basis.  Any requests which would
  1128.                create more traffic than this will be rejected. 
  1129.  
  1130.  
  1131.           ALLOWFIRSTREQUEST
  1132.  
  1133.                Is a flag that controls how V-MailServer will
  1134.                process the first request of the day.  Say you
  1135.                have a daily limit of 100,000 bytes.  You also
  1136.                have a number of files on your system that are
  1137.                larger than this.  If ALLOWFIRSTREQUEST is 1,
  1138.                V-MailServer will allow a request for a very large
  1139.                file, but only if it the first request of the day. 
  1140.                In this way you can allow access to large files
  1141.                without having high daily limits.
  1142.  
  1143.  
  1144.  
  1145.           Copyright (c) 1991 Richard Vandenberg and
  1146.           Vandenberg Systems Research                          12
  1147.  
  1148.  
  1149.  
  1150.  
  1151.                                                               Configuration
  1152.                                               
  1153.           
  1154.  
  1155.           PASSWORDFILE
  1156.  
  1157.                The name of the file that contains the password
  1158.                information.
  1159.  
  1160.  
  1161.           AFSFILE
  1162.  
  1163.                The list of addresses and the file to send in
  1164.                response to a message.
  1165.  
  1166.  
  1167.           MAILINGLISTS
  1168.  
  1169.                Contains the names of all the mailing lists and
  1170.                the files that contain each one.
  1171.  
  1172.  
  1173.           QUEUEDIR
  1174.  
  1175.                The name of the directory that contains the files
  1176.                that are queued to be mailed.  If you wish V-
  1177.                MailServer to mail requests as soon as they re
  1178.                processed, comment this line out.
  1179.  
  1180.  
  1181.           QUEUELIMITFILE
  1182.  
  1183.                The QueueLimitFile is a file that holds totals
  1184.                used by the limit option of VMAILX.  It will be
  1185.                automatically created if necessary.
  1186.  
  1187.  
  1188.           SEQF
  1189.  
  1190.                Used to hold an integer used in creating temporary
  1191.                files.
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.           Copyright (c) 1991 Richard Vandenberg and
  1211.           Vandenberg Systems Research                                    13
  1212.  
  1213.  
  1214.  
  1215.  
  1216.           V-MailServer User Manual
  1217.            
  1218.           
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.           Copyright (c) 1991 Richard Vandenberg and
  1276.           Vandenberg Systems Research                                    14
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.                                                        Command Line Options
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.           V-MailServer has a number of command line options. They are
  1291.           listed below, along with the options for the utilities that are
  1292.           supplied with V-MailServer.
  1293.  
  1294.  
  1295.           VMAIL Options
  1296.  
  1297.           -c Configuration File
  1298.  
  1299.                Allows you to specify an alternative configuration file to
  1300.                that specified in the VMS environment variable.
  1301.  
  1302.  
  1303.           -d
  1304.  
  1305.                Debug mode.
  1306.  
  1307.  
  1308.           -f FileName
  1309.  
  1310.                Use the supplied file instead of reading from the standard
  1311.           input.
  1312.  
  1313.  
  1314.           -t ToAddress
  1315.  
  1316.                Force V-MailServer to use the specified 'To:' address
  1317.                instead of the one in the header.
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.           Copyright (c) 1991 Richard Vandenberg and
  1341.           Vandenberg Systems Research                                    15
  1342.  
  1343.  
  1344.  
  1345.  
  1346.           V-MailServer User Manual
  1347.            
  1348.           
  1349.  
  1350.           VMAILX Options
  1351.  
  1352.           -c Configuration File
  1353.  
  1354.                Allows you to specify an alternative configuration file to
  1355.                that specified in the VMS environment variable.
  1356.  
  1357.  
  1358.           -d
  1359.  
  1360.                Debug mode.
  1361.  
  1362.  
  1363.           -s FileSpec
  1364.  
  1365.                Process only those queued requests that match the given file
  1366.                specification.  You must use '.X' as the extension. For
  1367.                example,
  1368.  
  1369.                      VMAILX -s VS*.X
  1370.  
  1371.                will process all the status messages that are queued.
  1372.  
  1373.  
  1374.           -l limit
  1375.  
  1376.                Only process requests up to the specified limit. The total
  1377.                number of bytes processed is held in the QueueLimitFile.
  1378.                VMAILX will defer processing any queued files that would
  1379.                cause the limit to be exceeded.
  1380.  
  1381.                You must periodically use the -r option to erase the
  1382.                QueueLimitFile, or manually delete it.
  1383.  
  1384.                Using the limit option may cause the files to be sent in the
  1385.                wrong order, because any that are too large are bypassed,
  1386.                and smaller ones sent.
  1387.  
  1388.                VMAILX will not process any requests larger than the limit
  1389.                specified. If you need to flush the queue, either specify an
  1390.                abnormally large limit, or do not use the limit function one
  1391.                time to process all queue requests.
  1392.  
  1393.           -r
  1394.  
  1395.                Reset (erase) the QueueLimitFile before processing the
  1396.                queued items.
  1397.  
  1398.  
  1399.           A few examples:
  1400.  
  1401.           VMAILX 
  1402.  
  1403.  
  1404.  
  1405.           Copyright (c) 1991 Richard Vandenberg and
  1406.           Vandenberg Systems Research                                    16
  1407.  
  1408.  
  1409.  
  1410.  
  1411.                will process all the queued requests ( flush the queue ).
  1412.  
  1413.  
  1414.           VMAILX -r
  1415.  
  1416.                Flush the queue, and reset the QueueLimitFile
  1417.  
  1418.  
  1419.           VMAILX -l 600000
  1420.  
  1421.                Process a maximum of 600000 bytes of queued requests
  1422.  
  1423.  
  1424.           VMAILX -l 600000 -r
  1425.  
  1426.                Process a maximum of 600000 bytes of queued requests, but
  1427.                reset the QueueLimitFile before starting.
  1428.  
  1429.  
  1430.           VMAILX -s VS*.X
  1431.  
  1432.                Process only the status messages.
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.           Copyright (c) 1991 Richard Vandenberg and
  1471.           Vandenberg Systems Research                                    17
  1472.  
  1473.  
  1474.  
  1475.  
  1476.           V-MailServer User Manual
  1477.            
  1478.           
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.                                                                 Other Files
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.           UserDir File and UserSecurity File
  1491.  
  1492.           Before any user may have access to the private mailing list
  1493.           features, a user directory must be set up. Two files are used to
  1494.           control user access to other directories - the UserDir file and
  1495.           the UserSecurity file. These two files are used for the same
  1496.           purposes as the SearchTree and ValidPaths files.  In the UserDir
  1497.           file, you specify the user's 'home' directory.  In the
  1498.           UserSecurityFile you specify the legal paths that a user may
  1499.           access.  You may give partial domain names in both of these
  1500.           files.
  1501.  
  1502.  
  1503.  
  1504.           Request Processing
  1505.  
  1506.           When requests are processed by V-MailServer, they can either be
  1507.           mailed immediately, or placed in the request queue for later
  1508.           mailing.  If they are queued, the VMAILX program is used to mail
  1509.           the requests. The QUEUEDIR configuration entry is used to control
  1510.           this feature.  If the QUEUEDIR entry is not included,
  1511.           V-MailServer will mail requests as soon as they are processed. 
  1512.           If QUEUEDIR is used V-MailServer will process the request and
  1513.           place the request in the specified directory.
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.           Copyright (c) 1991 Richard Vandenberg and
  1536.           Vandenberg Systems Research                                    18
  1537.  
  1538.  
  1539.  
  1540.  
  1541.                                                                 Other Files
  1542.                                               
  1543.           
  1544.  
  1545.           List server functions
  1546.  
  1547.           V-MailServer implements two type of mailing list facilities -
  1548.           public mailing lists and private mailing lists.
  1549.  
  1550.           Public mailing lists are accessed much like the well known BITNET
  1551.           LISTSERV mailing lists.  People use the SUBSCRIBE and UNSUBSCRIBE 
  1552.           commands to add or remove themselves from the applicable mailing 
  1553.           lists.  All messages are sent to the list address, and are then
  1554.           forwarded to all members of that mailing list.
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.           Copyright (c) 1991 Richard Vandenberg and
  1601.           Vandenberg Systems Research                                    19
  1602.  
  1603.  
  1604.  
  1605.  
  1606.           V-MailServer User Manual
  1607.            
  1608.           
  1609.  
  1610.           Public Mailing List Files
  1611.  
  1612.  
  1613.           Mailing lists are each maintained in a single file.  The files
  1614.           are simple ASCII files, with a single character flag followed by
  1615.           the address of the subscriber.
  1616.  
  1617.           eg - 
  1618.  
  1619.           TVMAIL-L V-MailServer Issues List
  1620.           Rvmail-l@vsystem.wimsey.bc.ca
  1621.           Ic:\user\vmail-l\vmail.int
  1622.           1rick@vsystem.wimsey.bc.ca
  1623.           0SomeOldID@some.other.site
  1624.           1AnActiveName@abusy.site
  1625.           2Somebody@else.UUCP
  1626.  
  1627.  
  1628.           The flag values are as follows:
  1629.  
  1630.           0 - Old member that UNSUBSCRIBEd from the list
  1631.           1 - Active members, echo disabled
  1632.           2 - Active members, echo enabled
  1633.  
  1634.           There are also 'header' flags:
  1635.  
  1636.           T - The title of the mailing list.
  1637.                Used in the 'Sender:' line, and as a title for the REVIEW
  1638.                command.
  1639.  
  1640.           R - The full 'Reply-To:' address for the mailing list.
  1641.                If this line is defined, the given address is used in the
  1642.                Reply-To: field. Otherwise the address the original message
  1643.                was sent to is used.
  1644.  
  1645.           I - The name of the introduction file to send when people
  1646.                subscribe to the list.
  1647.                This file is very useful for providing an initial
  1648.                orientation to new subscribers.  Suggestions for content
  1649.                include what the list is about, where to send submissions,
  1650.                and how to signoff the list.  An example introduction file
  1651.                is supplied with V-MailServer.
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.           Copyright (c) 1991 Richard Vandenberg and
  1666.           Vandenberg Systems Research                                    20
  1667.  
  1668.  
  1669.  
  1670.  
  1671.                                                                 Other Files
  1672.                                               
  1673.           
  1674.  
  1675.           Private Mailing List Files
  1676.  
  1677.  
  1678.           Private mailing lists are set up at the discretion of the system
  1679.           administrator.  Files and mailing lists may be manipulated in
  1680.           user directories assigned to specific users. This type of
  1681.           functionality is useful for providing information or files to a
  1682.           private group of people. 
  1683.  
  1684.           A brief summary of these commands:
  1685.  
  1686.                PUT         - send a file to a user directory
  1687.                CREATELIST  - create a mailing list file
  1688.                RESENDLIST  - resend a file using a mailing list
  1689.                FILES       - retrieve the list of files in a user directory
  1690.                KILL        - erase a file in a user directory
  1691.  
  1692.  
  1693.  
  1694.           Request Logging
  1695.  
  1696.           All commands are logged in a user specified log file, along with
  1697.           the  address of the requester and the date and time of the
  1698.           request.
  1699.  
  1700.  
  1701.  
  1702.           Traffic Control File
  1703.  
  1704.           The Traffic Control file maintains a record of all V-MailServer
  1705.           activity.  All file requests and mailing list activity is logged
  1706.           here.  The main use of the Traffic Control file is for rate
  1707.           limiting. Before a file request is processed, the applicable
  1708.           traffic control entries are totalled to determine if the request
  1709.           should be accepted or not.
  1710.  
  1711.           The traffic control file will grow very large, and for this
  1712.           reason two programs are supplied to remove old traffic records
  1713.           and create a comma-delimited format file of the traffic
  1714.           information.  The two programs are documented in the 'Additional
  1715.           Programs section, Page 22.
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.           Copyright (c) 1991 Richard Vandenberg and
  1731.           Vandenberg Systems Research                                    21
  1732.  
  1733.  
  1734.  
  1735.  
  1736.           V-MailServer User Manual
  1737.            
  1738.           
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.                                                         Additional Programs
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.           KILLTRAF
  1751.  
  1752.           The KillTraf program is used to remove old traffic records from
  1753.           the traffic control file. Contrary to what the name seems to say,
  1754.           KillTraf doesn't actually remove traffic records. It lets you
  1755.           create a new traffic file that contains only current traffic.
  1756.           It's up to you to remove the old traffic file if you want.
  1757.  
  1758.  
  1759.           Usage: 
  1760.  
  1761.           KILLTRAF -f OutputFile [-d mm-dd-yyyy] [-t hh:mm:ss ]
  1762.  
  1763.           If the date is not specified, KILLTRAF uses the current date.
  1764.           If the time is not specified, KILLTRAF uses 00:00:00.
  1765.  
  1766.  
  1767.  
  1768.           TRAF2CDF
  1769.  
  1770.           The Traf2CDF program will create a comma-delimited format file
  1771.           containing the traffic records. The output is produced on the
  1772.           standard output, and hence must be redirected for any useful
  1773.           purpose.  This program may be useful if you want to perform
  1774.           traffic analysis using database software such as dBase.
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.           Copyright (c) 1991 Richard Vandenberg and
  1796.           Vandenberg Systems Research                                    22
  1797.